Crear un proyecto nuevo

¿Qué es un proyecto?

Un proyecto en R-Studio es una carpeta que el programa reconoce como un entorno de trabajo de R, proporcionando un grado de organización superior respecto al trabajo habitual con el software.

  1. Dar click en Project: (None) y New Project


  1. Escoger directorio (nuevo o existente)

    • Nuevo: R creará una carpeta nueva con el nombre que usted asigne al proyecto.
    • Existente: R creará el proyecto dentro de una carpeta existente (creada por el usuario previamente)


  1. Escoger directorio de trabajo en el pc


  1. Create project

  2. Listo…el proyecto ha sido creado. Deberá aparecer en la parte superior derecha (donde decía Project: (None)) el nombre del proyecto, en este caso se llama “GUIONES”.


Luego de crear el proyecto ¿Qué sigue?

Si ya ha creado el proyecto, tendrá el entorno de trabajo listo para empezar a ejecutar código de R. Hay que tener en cuenta que la carpea donde está albergado el proyecto (.Rproj) deberá contener todos los archivos (por ejemplo, bases de datos) necesarios para comenzar a trabajar. Hasta el momento sólo se cuenta con el proyecto, es decir, el entorno de trabajo está listo, sin embargo, hace falta un nuevo script (.R) o un archivo RMarkdown (.Rmd) que permita incorporar código de R y al mismo tiempo, generar documentos automáticos.

Nuevo documento RMarkdown (.Rmd) (HTML)

  1. Click en File
  2. Click en New file
  3. Click en Rmarkdown

    • Agregar título al documento
    • Agregar nombre al documento
    • Escoger el tipo de documento (para este caso será HTML)
  4. Ok


Se producirá automáticamente un documento sin título (Untitled1) (flecha roja) con una plantilla de RMarkown, como se muestra en la siguiente imagen.


  1. Como el documento está sin título lo primero que se podría hacer es guardar el archivo .Rmd con un nombre cualquiera, sin embargo, dando click en Knit (flecha azul) se obtiene una ventana que permite añadir un nombre y guardar el archivo. Esto debido a que el documento necesita estar guardado para ser compilado y obtener finalmente el .html.


Como se está creando un nuevo archivo .Rmd dentro del proyecto (flecha verde), por defecto la carpeta que deberá presentarse al surgir esta ventana, es la carpeta del proyecto. En este caso, a manera de ejemplo, el archivo lo llamé Taller1 y automáticamente se abre este documento:


Nota: Este documento es producto de la plantilla básica que trae por defecto R para presentar al usuario la manera de compilar documentos Markdown junto con código R.

  1. El nombre con el cual se ha guardado el documento (en este caso Taller1) dará origen a un nuevo documento .html con el mismo nombre, dentro de la carpeta del proyecto, este podrá ser ejecutado con cualquier navegador (recomendablemente Chrome o Firefox).


Trabajando con RMarkdown (HTML)

Con el proyecto y el archivo .Rmd creados, es momento de empezar a construir el nuevo documento .html, es decir, comenzar a ejecutar código R.

  1. Lo primero que se puede hacer es borrar todo desde ## R Markdown (flecha roja) hasta el final, dejando solo los metadatos (título, autor, fecha) y las opciones generales del documento.


Luego de borrar se tienen únicamente los metadatos y las opciones generales.


Los metadatos

Los metadatos son datos que describen otros datos, información adicional que permite la localización de objetos informativos. Para el ejemplo, los metadatos son los siguientes:


  • title: título del documento
  • author: nombre del autor del documento
  • date: fecha de creación del documento
  • output: tipo de documento a compilar, en este caso, documento HTML (html_document)

Nota: Los metadatos siempre deben estar entre guíones (tres iniciales y tres finales).

Fragmentos (chunk) de código R

Los fragmentos de código R se pueden usar como medio para representar la salida de R en determinados documentos o simplemente para mostrar el código con fines ilustrativos. El primer chunk de R que tiene por defecto el documento es de las opciones generales, tal cual como este:


Los fragmentos de código R servirán para ejecutar código R y anexarlos al documento que se está construyendo; aquello que está por fuera de el chunk no es código R, necesariamente hay que incorporar fragmentos cuando se requiera ejectutar código R. Para insertar un frágmento hay que hacer lo siguiente:

  • Click en Insert
  • Click en R
  • O simplemente CTRL + Alt + i


Este es un frágmento luego de realizar el proceso de insertar:


Se tendrá entonces el documento de esta manera:


Nota: algunas salvedades respecto a la imagen anterior:

  • Como el título Taller1.Rmd aparece en color rojo (flecha roja) quiere decir que hay cambios sin guardar, para guardar se puede dar click en el disco (flecha verde) y automáticamente cambiará de color.
  • Si se pretende ejecutar el código incluido dentro del fragmento, se puede hacer desde el botón verde (flecha amarilla) o como se ejecuta habitualmente.
  • Si se pretende ejecuatar todos los fragmentos de cógido anteriores a uno específico, se puede dar click en el botón gris (flecha azul).

Ejemplo con la base de datos Encuesta.csv

  1. Una de las maneras de agregar títulos en Markdown es por medio de los numerales (#), indicando lo siguiente:

    • #: Primer encabezado o título principal
    • ##: Segundo encabezado o título secundario (subtítulo)
    • ##: Tercer encabezado
    • A manera de ejemplo, se agregan el título principal y un encabezado secundario, con nombres Análisis de encuesta y Consulta 1. ¿Qué porcentaje de encuestados poseen Smartphone?, respectivamente. Además, se cambió el título del documento.


Obteniendo un documento como este:


  1. Agregar fragmentos de código R para empezar a procesar los datos de la encuesta y responder a esa primera consulta. En este caso, se insertan dos fragmentos de código R, uno para importar los datos e incluirlos dentro de un objeto que llamé encuesta y otro para dar solución a la primera pregunta.


Nota:

  • El fragmento 1 posee las opciones generales.
  • El fragmento 2 posee código de R para importar la base de datos Encuesta.csv y asignarla dentro de un objeto que se llama encuesta.
  • EL fragmento 3 posee código de R para dar solución a la pregunta.
  • Finalmente, se redacta la respuesta.

Al dar click en Knit de nuevo, se producirá el siguiente documento:


Instalación de bibliotecas o paquetes

Para instalar bibliotecas se puede hacer por medio de código o a través de la interfaz de R-Studio.

  1. Con código:

    • Se usa la función install.packages()
    • A la función anterior, como primer argumento se agrega el nombre entre comillas de la biblioteca que se desea instalar (en este caso es la biblioteca moments) y el segundo argumento (dependencies) se iguala a TRUE, indicando con esto último, que además de la biblioteca moments instale las dependencias necesarias para esa biblioteca (algo muy común en R).
    • Ejecutar este código install.packages("moments", dependencies = TRUE)
    • En la consola de resultados aparecerá lo siguiente:


Indicando que la biblioteca fue descargada e instalada satisfactoriamente.

  1. Con la interfaz de R-Studio:

    • Click en Packages (flecha roja)
    • Click en Install (flecha azul)
    • Escribir el nombre de la biblioteca (en este caso es moments)
    • El cuadro de dependencias (Install dependencies) debe estar señalado para que instale las bibliotecas complementarias a la que se pretende instalar. (flecha verde)
    • Click en Install (flecha naranja)